home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / standard / dither.z / dither
Encoding:
Text File  |  2002-10-03  |  4.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ddddiiiitttthhhheeeerrrr((((3333GGGG))))                                                          ddddiiiitttthhhheeeerrrr((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ddddiiiitttthhhheeeerrrr - controls the dithering of pixels
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd ddddiiiitttthhhheeeerrrr((((mmmmooooddddeeee))))
  13.      lllloooonnnngggg mmmmooooddddeeee;;;;
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _m_o_d_e   expects one of two values:
  17.  
  18.             DDDDTTTT____OOOOFFFFFFFF disables dithering.
  19.  
  20.             DDDDTTTT____OOOONNNN enables dithering (default).
  21.  
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.      Dithering is a pixel operation that attempts to convey as accurately as
  25.      possible the color of an image when the framebuffer stores fewer bits of
  26.      color than are being computed or iterated.  This is done by creating a
  27.      pattern of carefully chosen colors that, when viewed from a distance of a
  28.      few feet or more, give the illusion of an accurately shaded image.  For
  29.      example, if only 4, 8, or 12 bitplanes are available in the framebuffer,
  30.      and color is being iterated with 24 bits (8 bits for each of red, green,
  31.      and blue), dithering can be used to modulate the drawn colors to better
  32.      approximate the 24 bit image.
  33.  
  34.      Dithering works in both RGB and color index modes.  In RGB mode,
  35.      dithering is performed independently for red, green, blue, and alpha.
  36.      When blending is enabled, blending occurs before dithering and uses the
  37.      full precision of the iterated colors.  Dithering works on all drawing
  38.      primitives:  points, lines, text, polygons, and pixel writes and copies.
  39.      However, dithering has no effect if the framebuffer stores all the
  40.      computed bits of color.  For example, pixel copies from framebuffer to
  41.      framebuffer are not dithered.
  42.  
  43.      Dithering is enabled by default.  When drawing pre-dithered images, or
  44.      when drawing single-width RGB lines on a 4 or 8-bit framebuffer, it may
  45.      be best to turn dithering off.
  46.  
  47. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  48.      color, colorf, getgdesc
  49.  
  50. NNNNOOOOTTTTEEEESSSS
  51.      Some IRIS-4D models do not support dithering. Use ggggeeeettttggggddddeeeesssscccc((((GGGGDDDD____DDDDIIIITTTTHHHHEEEERRRR)))) to
  52.      determine whether dithering is supported.  Some machines support
  53.      dithering only in RGB mode.  If ggggeeeettttggggddddeeeesssscccc((((GGGGDDDD____CCCCIIIIFFFFRRRRAAAACCCCTTTT)))) is FALSE then
  54.      dithering is not supported in colorindex mode.
  55.  
  56.      On all RealityEngine models, there is hardware support for video
  57.      dithering enabled by default.  This feature differs from render dithering
  58.      because it only affects the pixels on the way out to the video.  On
  59.      RealityEngine this dithering takes the 12-bit components and dithers them
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ddddiiiitttthhhheeeerrrr((((3333GGGG))))                                                          ddddiiiitttthhhheeeerrrr((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      to 10 bits before they are sent to the gamma lookup (which then outputs 8
  75.      bits per component).  On releases prior to Irix 5.3, this feature was
  76.      enabled through this call.  Video dithering is no longer affected by this
  77.      call by default.  To re-enable this call you'll need to setenv
  78.      RRRREEEE____EEEENNNNAAAABBBBLLLLEEEE____DDDDIIIITTTTHHHHEEEERRRRCCCCMMMMDDDD.
  79.  
  80.      On all Personal Iris models, dithering can be enabled only when drawing
  81.      in one of the following modes: sssshhhhaaaaddddeeeemmmmooooddddeeeellll((((GGGGOOOOUUUURRRRAAAAUUUUDDDD)))) or ddddeeeepppptttthhhhccccuuuueeee((((TTTTRRRRUUUUEEEE)))).
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.